home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / tls / tls013.ltr < prev    next >
Text File  |  1994-09-02  |  2KB  |  67 lines
  1.         Cmdopts OSF/Motif example program.
  2.         ==================================
  3.  
  4.             DISCLAIMER
  5.  
  6. This directory contains UNSUPPORTED example programs.
  7.  
  8. Software in this directory is provided in source form only.  SCO does not
  9. guarantee that the software contained here is suitable for any particular
  10. purpose,  and does not undertake to provide support for it.  SCO does not
  11. guarantee that the software will compile or run on any particular system.
  12.  
  13. ---------------------------------------------------------------------------
  14.  
  15. Files:
  16. ------
  17.  
  18. Makefile    makefile for example program
  19. def.g        BNF of command definition language.
  20. def.l        LEX tokeniser definition
  21. def.y        YACC grammar for definition language
  22. cmds.def    Example command definitions file
  23. main.c        Main program
  24. interface.c    Interface setup code
  25. dialog.c    Dynamic stuff
  26.  
  27.  
  28. To run:
  29. -------
  30.  
  31. cmdopts < cmds.def
  32.  
  33. Overview:
  34. ---------
  35.  
  36. The program reads a file of command definitions from stdin, creating
  37. a parse tree.  The interface is set up,  and the commands list
  38. box is filled from the tree.
  39.  
  40. When a command is selected,  a series of widgets is created dynamically
  41. according to the descriptions stored in the appropriate segment of
  42. the parse tree.  Callbacks are set up which build the command string,
  43. and display it in a window.
  44.  
  45. The command may be executed either in an xterm or in background.  Current
  46. directory change and basic I/O redirection (< and >) are supported,
  47. but the program is a long way from being a graphical UNIX shell !
  48.  
  49. Bugs:
  50. -----
  51.  
  52. The activate Callback associated with the text widget in the dialog
  53. to change working directory doesn't work.
  54.  
  55. There is a problem running commands which perform input inside an xterm:
  56. they hang the window manager and the application.  Running in background
  57. means that input is still attached to the xterm from which cmdopts was
  58. run: this seems to work OK.
  59.  
  60. Running xwd from cmdopts doesn't work:  an X error is generated when it
  61. tries to grab the pointer device.
  62.  
  63. The command definition language is not capable of describing some
  64. UNIX commands adequately (e.g. tar),  and could be improved in a number
  65. of ways.  Error reporting on syntax errors is abysmal: binary chop the
  66. commands file to find the source of the error.
  67.